package com.example.demo.service;

import com.example.demo.dto.UserLoginDTO;
import com.example.demo.dto.UserLoginResponseDTO;
import com.example.demo.dto.UserRegisterDTO;
import com.example.demo.model.User;
import java.util.List;

/**
 * 用户服务接口
 */
public interface UserService {
    /**
     * 用户登录
     */
    UserLoginResponseDTO login(UserLoginDTO loginDTO);
    
    /**
     * 用户注册
     */
    UserLoginResponseDTO register(UserRegisterDTO registerDTO);
    
    /**
     * 根据ID查询用户
     */
    User findById(Integer userId);
    
    /**
     * 根据用户码(学号/教师工号)查询用户
     */
    User findByUsercode(String usercode);
    
    /**
     * 根据邮箱查询用户
     */
    User findByEmail(String email);
    
    /**
     * 根据组织ID查询用户列表
     */
    List<User> findByOrgId(Integer orgId);
    
    /**
     * 根据用户类型查询用户列表
     */
    List<User> findByUserType(String userType);
    
    /**
     * 根据组织ID和用户类型查询用户列表
     */
    List<User> findByOrgIdAndUserType(Integer orgId, String userType);
    
    /**
     * 查询所有待审核的教师
     */
    List<User> findPendingTeachers();
    
    /**
     * 查询所有用户
     */
    List<User> findAll();
    
    /**
     * 创建用户
     */
    User create(User user);
    
    /**
     * 更新用户
     */
    User update(User user);
    
    /**
     * 审批教师账号
     */
    boolean approveTeacher(Integer userId, Integer approverId, boolean isApproved, String comment);
    
    /**
     * 删除用户
     */
    boolean deleteById(Integer userId);
    
    /**
     * 检查用户码(学号/教师工号)是否存在
     */
    boolean checkUsercodeExists(String usercode);
    
    /**
     * 检查邮箱是否存在
     */
    boolean checkEmailExists(String email);
    
    /**
     * 修改用户密码
     */
    boolean changePassword(Integer userId, String oldPassword, String newPassword);
    
    /**
     * 设置用户的管理员角色
     */
    boolean setAdminRole(Integer userId, String adminRole);
    
    /**
     * 将User对象转换为UserLoginResponseDTO对象
     */
    UserLoginResponseDTO convertToResponseDTO(User user);

    /**
     * 根据组织ID及其所有子组织查询用户
     */
    List<User> findByOrgTreeAndUserType(Integer orgId, String userType);
}
